Рекомендации по файловой структуре

В создании маркван-сайта нет ничего сверхъестественного. Просто упорядочьте файлы со своими произведениями — раскладывайте их по папкам. Программа сможет проанализировать эту структуру и выдать готовый сайт.

Разделение и иерархия информации

Каждый текст должен находиться в персональной папке.

Помимо текстового файла в папке могут находиться иллюстрации или другие материалы. Этот контент можно складывать в подпапки.

▒ Проект сайта
├─▒ Приключения
│ ├─▒ media
│ │ ├─ baikal.png
│ │ └─ tibet.png
│ └── Приключения.text
├─▒ Мои стихи
│ ├─▒ Про ландыш
│ │ ├─ Весенний ландыш.text
│ │ └─ Ландыш.jpg
│ └─▒ Радость
│   └─ Радость жизни.text
├─▒
│ └─ Обо мне.text
└─ Главная.text

Правила именования файлов и папок

В названиях файлов можно использовать буквы и цифры, знак подчёркивание _ и минус -. Точка . используется только для отделения расширения файла.

В названиях папок можно использовать буквы и цифры, знак подчёркивание _ и минус -. Знаки точка . и тильда ~ понадобятся нам для разметки.

Скрытая страница

Если какие-то папки не нужно преобразовывать в сайт, поставьте точку перед названием .Секретная папка

Нумерация папок для сортировки

При автоматическом создании сайта папки и файлы будут отсортированы по наименованию. Чтобы сделать сортировку так как нужно вам, используйте маркван-нумерацию папок.

Вы можете отделить номер от названия знаком дефис -. Например, 5-Наименование папки. Этот номер при конвертации будет учтён, но при формировании меню останется только чистое наименование папки.

Страницы-списки

Этот функционал пока не реализован. Непонятно откуда взять анонсы.

Допустим, у вас есть большой список стихотворений и вы не хотите, чтобы название каждого выводилось в меню, но пользователь смог перейти на каждое из них. Для этого перед названием папки проставьте знак тильда ~. Например, ~Мои стихи или 4~Каталог товаров. Пользователь получит список этих материалов соединенный с текстовым файлом - описанием этого списка.